<TITLE>gethostname</TITLE>
<body bgcolor="#ffffcc">
<hr>
<pre>



<h3>GETHOSTNAME(2)      Linux Programmer's Manual      GETHOSTNAME(2)
</h3>

<h3>NAME
</h3>       gethostname, sethostname - get/set host name

<h3>SYNOPSIS
</h3>       #include &lt;unistd.h&gt;

       int gethostname(char *name, size_t len);
       int sethostname(const char *name, size_t len);

<h3>DESCRIPTION
</h3>       These  functions  are used to access or to change the host
       name of the current processor.

<h3>RETURN VALUE
</h3>       On success, zero is returned.  On error, -1  is  returned,
       and errno is set appropriately.

<h3>ERRORS
</h3>       EINVAL len  is negative or, for sethostname, len is larger
              than the maximum allowed size, or, for  gethostname
              on Linux/i386, len is smaller than the actual size.

       EPERM  For sethostname, the caller was not the  superuser.

       EFAULT name is an invalid address.

<h3>CONFORMING TO
</h3>       POSIX.1  does  not  define  these  functions,  but ISO/IEC
       9945-1:1990 mentions them in B.4.4.1.

<h3>BUGS
</h3>       Some other  implementations  of  gethostname  successfully
       return len bytes even if name is longer.  Linux/Alpha com-
       plies with this behaviour.  Linux/i386,  however,  returns
       EINVAL in this case (as of DLL 4.6.27 libraries).

<h3>NOTES
</h3>       Under  Linux/Alpha,  gethostname  is a system call.  Under
       Linux/i386, gethostname  is  implemented  at  the  library
       level by calling uname(2).

</pre>
<hr>
<h3>SEE ALSO
</h3><p>
<a href=getdomainname.htm>getdomainname</a>, 
<a href=setdomainname.htm>setdomainname</a>, 
<a href=uname.htm>uname</a>, 
<pre>














<h3>Linux 1.3.6                22 July 1995                         1
</h3>

</pre>
<P>
<hr>
<p>
<center>
<table border=2 width=80%>
<tr align=center>
<td width=25%>
<a href=../cref.html>Top</a>
</td><td width=25%>
<a href=../master_index.html>Master Index</a>
</td><td width=25%>
<a href=../SYNTAX/keywords.html>Keywords</a>
</td><td width=25%>
<a href=../FUNCTIONS/funcref.htm>Functions</a>
</td>
</tr>
</table>
</center>
<p>
<hr>

This manual page was brought to you by <i>mjl_man V-2.0</i>
